Introduce `tipjartype` and `tipjarsource` URL parameters to filter
tips by unit (e.g., stars, bits) or platform (e.g., Facebook, YouTube).
When a filter is active, the jar displays raw unit counts and uses
separate persistent storage per filter combination.

- **sources/facebook.js**: Add `donoValue` field (100 Stars = $1 USD)
- **parameters.md**: Document new tip jar parameters (`tipjartype`,
  `tipjarunit`, `donationtype`, `tipjarsource`, `donationsource`,
  `tipjarunitlabel`, `persistent`, `controls`, `sound`, `hype`)
- **popup.html**: Add dropdown UI for donation type and source filters
- **tipjar.html**: Parse filters, update storage keys, CSV export, and
  history totals; adjust total display for native unit mode
- **docs/event-reference.html**: Update Facebook Stars entry to mention
  `donoValue`

[auto-enhanced]

- Introduce new "bar" display style for the tip jar/ goal meter with configurable fill colors (fillstart, fillend) and fill behavior (progress, gradient, solid)
- Add recurring level support via `levelsize` parameter, enabling repeating goal increments
- Implement additional customization parameters: barheight, noliquid, theme, celebration
- Update popup.html UI with controls for fill color, fill mode, and recurring increment
- Document all new parameters in parameters.md
- Bump manifest version to 3.50.1

[auto-enhanced]

- Introduce `levelRolloverTimer` and `levelCompletionState` to display a completed level briefly before rolling over.
- Modify `updateAmount()` to clear level state on non‑positive amounts or when the level hasn’t advanced, ensuring rollover only triggers on actual level changes.
- Update `resetTipJarAmount()` to call `clearLevelCompletionState()`, so manual resets properly clear any pending rollover display.
- Refine `renderAmount()` and `getProgressState()` to check for the completion state, enabling the brief “level complete” visual before returning to normal progress.

[auto-enhanced]

Extend tipjar with three new display styles (compact bar, vertical bar, text-only) and a test donation panel that sends simulated platform donations (Facebook Stars, YouTube SuperChat, Twitch Bits, TikTok Hearts) directly from the popup. Reorganize tipjar options into separate collapsible sections (General Controls, Hype Cup Scoring, Style/Goal/Filters, Test Donations) for better UX. Update parameters.md with the new style options and the `barradius` parameter, and add corresponding UI elements in popup.html and popup.js.

[auto-enhanced]

Add a new UI toggle and corresponding logic to display only the
progress bar with the text embedded inside, hiding the title and
meta sections. This provides a more compact visualization suitable
for limited-space overlays.

- popup.html: add "Only show the bar, with text inside" checkbox
  mapped to the `baronly` parameter
- tipjar.html: apply `bar-only` CSS class to hide title/meta,
  adjust text rendering to include the title and progress within
  the bar fill

[auto-enhanced]

- Add normalizeDonationTypeFilter() to convert 'cash' to 'usd'
- Update nativeUnitMode to only enable if filter is not 'usd'
- Use normalized filter in donationMatchesTypeFilter()
- Append test tube emoji to 'Test Donations' label in popup.html

[auto-enhanced]

[auto-enhanced]

- Store `memberLevel` in `avatarCache` from TikTok rank/grades
- Add `addTikTokEventMeta` helper to attach follower flag and member level to event `data.meta`
- Update `avatarCache.add` signature to accept and persist `memberLevel`
- Rework TTS follower condition: check both `meta.follower` and event name keywords instead of nested `meta.tiktok.follower`
- Read `meta.memberLevel` directly in `tts.js`, removing the nested `data.meta.tiktok` structure

[auto-enhanced]

Reformat the `.then/.catch` chaining in the `trackSdkSendResult` function
to improve readability and align with project linting rules.
This follows up on the server fallback diagnostics added in e12000a.

[auto-enhanced]

- Add `actions/examples/kick-channel-points-action-flow.json` as an importable Event Flow example for Kick reward redemptions.
- Add `docs/kick-channel-points-event-flow.md` with detailed setup instructions, template variables, and troubleshooting.
- Extend `getDockTransportHealth()` in `background.js` with `fakeMessageTransportReady` to indicate if a message transport (P2P or server fallback) is actually available.
- Update `popup.js` to use the new `fakeMessageTransportReady` property when deciding whether to show the fallback banner, simplifying the conditional logic.

This builds on the previous server fallback diagnostics work, ensuring the fake test message button reliably reports transport readiness. The new Kick channel points flow and documentation enable users to harness Kick reward redemptions in Event Flow.

[auto-enhanced]

Add new Kick channel points/rewards event flow documentation with screenshots and update the guides in `docs/guides.html` to link to this guide from the Flow Actions and OBS setup sections.

[auto-enhanced]

Reword the short answer for clarity and change the section heading
from "What Steve should tell the user" to "Overview".

[auto-enhanced]

… extraction plan

Introduce the initial documentation structure under `docs/agents/` to support AI agents answering questions about Social Stream Ninja.

- **00-inventory-and-plan.md**: catalogs existing project sources and proposes a comprehensive 12-section documentation plan
- **01-extraction-checklist.md**: defines extraction levels (quick, heavy, intense), a master checklist for all components, and an extraction pass log

[auto-enhanced]

- Added `13-reference/` index and cross-cutting lookup pages for commands, URL parameters, modes, free/paid boundaries, plugins/customization, support resources, and features/capabilities.
- Updated extraction checklist (`01-extraction-checklist.md`) to mark numerous heavy passes as complete (source inventory, platform sources, product map, support KB mining, etc.).
- Refined inventory plan (`00-inventory-and-plan.md`) with new page roles and updated open questions.

[auto-enhanced]

Address a security advisory by removing the `geolocation` permission from iframes in `aioverlay.html`, `bot.html`, and `dock.html`. Only the `midi` and `microphone` permissions are retained, with the microphone kept to maintain Safari WebRTC P2P connectivity.

Also expand the AI agent documentation inventory with new reference pages (glossary, surface URL cheatsheet, settings change impact matrix, public claims boundary matrix, and capability matrices) and update the extraction checklist to reflect recent heavy extraction passes.

[auto-enhanced]

Increase wildcardAgentRefCount from 41 to 49 to reflect new
wildcard references added in recent agent documentation updates
(e.g., AI agent framework and extraction progress).
Also add `docs/agents/*/SITEMAP.md` to the known wildcard patterns,
confirming it as an intentional cross-reference rather than a broken
link.

[auto-enhanced]

Add a new test source page (`testsource.html`) and content script (`testsource.js`) that dispatches custom `TestSourceMessage` events, allowing manual testing of chat overlay behavior without a live stream. The page includes predefined payloads, a custom message editor, and burst-send functionality. Updated `manifest.json` to register the new content script for the appropriate URLs.

[auto-enhanced]

- Add regex filters in `filterXSS` to block event handlers (e.g., `onclick=`, `onerror=`), `javascript:` URIs, the `srcdoc` attribute, and `data:` URIs (including `data:text/html`)
- Extend the WebSocket test source with false-positive test scenarios that verify safe mentions of XSS-related terms are not blocked
- Strengthen initial probe detection while preserving legitimate message content

[auto-enhanced]